Sybase:
On-Line Documentation

Sybase documentation resides in the directories under

 	/NextLibrary/Documentation/Sybase 
 
The documentation is organized in directories in this way:

Directory	Documentation
DBLIB	Library Reference Manual
Appendices	Appendices

The files are in nroff/troff source format and so must be processed before being viewed or printed.  The following sections describe several ways to access this documentation.  (See the UNIX manual on nroff and troff for more information.)

Searching

The Digital Librarian provides a convenient way to search and view on-line documentation.  Before you can use the Digital Librarian to access this documentation, however, you must add /NextLibrary/Documentation/NextDev/Sybase as a target.  See Chapter 13 ªThe Digital Librarian:  Searching for Informationº in the User's Reference Manual for information.

To preserve the formatting of the online documentation, you should use a monospaced font, such as Courier or Ohlfs.  Because the 2.0 version of the Digital Librarian displays text using the system font, you must change the system font using the Preferences applicationÐsee the NeXT User's Reference Manual for more complete instructions.  Alternatively, once the Digital Librarian has displayed the text, select all the text using Command-a and change the font using the Font Panel.  You may also want to enlarge the Digital Librarian's window so a line of formatted text is displayed on a single line.

Viewing

You can view either a fully formatted version of the documentation or an unadorned text version.  Normally, it's best to view the fully formatted version even though it takes a few moments longer to access.  

Viewing Formatted Documentation

To create a fully formatted version, you have to convert the source documentation to PostScript code which can then be displayed by Preview, the NeXT PostScript viewer.  Open a Shell or Terminal window, change directory to the directory containing the file or files you want to view, and enter the command: 

tbl filename | ptroff -t -msyb > /tmp/tempfile.eps 

In place of filename, substitute the file name of the file you want to view.  To view all the files in the current directory, substitute * for filename.  

Then you can launch the Preview application (/NextApps/Preview) and open /tmp/tempfile.eps for viewing.

Quick Scanning

To list a file or files directly to a Shell or Terminal window, use the following commands:  

tbl filename | nroff -t -msyb | more

The more UNIX utility lets you scroll through the text a screenful at a time.  For information, see the UNIX manual page on more.

Viewing the Table of Contents

Each section contains the the table of contents in the file toc.eps.  Open this file to see the table of contents.

Printing

Use the PrintManager application to specify which printer you want to have print the files.  Or, from an application such as WriteNow or the Digital Librarian, choose Print... and click on the Choose button.  The Choose Printer panel appears and you can select the printer you want to use.

To print a file or files, use this command:  

tbl filename | ptroff -msyb

To print the table of contents for a section, use this command:  

lpr toc.eps

Printing the Manual

To print the entire DB-Library manual:
	
cd /NextLibrary/Documentation/Sybase
make all